Open topic with navigation

HDF_DFAN_GETLABEL

The HDF_DFAN_GETLABEL procedure reads the label for the given tag-reference pair in an HDF file.

Syntax

HDF_DFAN_GETLABEL, Filename, Tag, Ref, Label

Arguments

Filename

A scalar string that contains the name of the file to be read.

Tag

The tag number.

Reference

The reference number.

Label

A named variable in which the label is returned as a string.

Keywords

None

Examples

fid = HDF_OPEN('test.hdf', /ALL)

label = 'TEST LABEL'

tag = 105 ; The annotation tag.

ref = 2 ; Choose a reference number.

; Write the label:

HDF_DFAN_PUTLABEL, 'test.hdf', tag, ref, label

; Read back the label:

HDF_DFAN_GETLABEL, 'test.hdf', tag, ref, outl

HELP, outl ; They look the same...

; Close the HDF file:

HDF_CLOSE, fid

Version History

See Also

HDF_DFAN_GETDESC, HDF_DFAN_LABLIST, HDF_DFAN_PUTDESC, HDF_DFAN_PUTLABEL